home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 32 / Amiga Format AFCD32 (Nov 1998, Issue 117).iso / -seriously_amiga- / programming / e / dech / dech.readme < prev    next >
Text File  |  1998-08-10  |  7KB  |  195 lines
  1. About DECH - Deniil E-Compiler Handler v1.33!
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. This program is made for you who program in Amiga-E and
  5. compile alot, which is usual, and is tired of CLI/Shell
  6. or the Workbench menu (ToolsDaemon)!
  7.  
  8. With this program can you easy select one or more files
  9. that you often compile and then with just ONE mouse-click
  10. compile the active file and one more click to run it!
  11. Or, why not both compile and run with one mouse-click!
  12.  
  13. * NEW * Now you don't need to have the window 350 metres tall,
  14.         you can shrink it to just EC/RP and select the file
  15.         from within the monitor-window instead!
  16.  
  17. * --- * Now you can copy files temporarly to "Ram:DECH/"
  18.         with DECH to speed up compiling and save the HD
  19.         some work!
  20.         All corresponding '*local' modules will also be copied
  21.         to Ram:DECH/ and placed in their reciprocal directories!
  22.         You can ofcource also save them (the files.e, not the
  23.         modules) back to their original locations on your HD
  24.         with another mouse-click!
  25.  
  26. Usage:
  27. ~~~~~~
  28. EC: E-Compile the first file in the right list
  29. RP: Run the Program compiled with EC
  30. Cn: Compile the n:th file in the right lister of the file-selector
  31. Rn: Run the Program compiled with Cn
  32. --
  33. ED: Select a file to open with your favorite text-EDitor
  34. V : Select a file to open with your favorite text-Viewer
  35. FS: Open/close the FileSelector
  36. C : Open/close the output that is a Console by default. (se notes below!)
  37. ? : Open/close the prefs-editor
  38. Q : Quit
  39.  
  40. All this buttons can also be controlled from the keybord:
  41. EC: F10
  42. RP: 0
  43. Cn: Fn, i.e. F1..F9
  44. Rn: n,  i.e. the numberkeys 1..9
  45. ED: 'e'
  46. V : 'v'
  47. FS: 'f'
  48. C : 'c'
  49. ? : '?'
  50. Q : 'q'
  51.  
  52. You can press the right mouse-button or 'Help' to get a small
  53. info-window with information of what the different gadgets do,
  54. or in v1.33+ you get the list of what was supposed to be the
  55. gadgets Cn/Rn if you "Reduce gadgets" (see below).
  56.  
  57.  
  58. The editor- and viewer-selector:
  59. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  60. If you press 'ED' or 'V' you will get a little window with
  61. some numbers and a C. With the editor also an E.
  62. Any number will open the corresponding file in your favorite
  63. text-editor/viewer.
  64. The C stands for 'Cancel'.
  65. The E stands for 'Empty editor'.
  66. The keys 'e', 'c' and the numbers 1..n also works here.
  67.  
  68.  
  69. The fileselector:
  70. ~~~~~~~~~~~~~~~~~
  71. The left lister is where all files comes in after you have
  72. selected them with 'Add'. One file or more will also always be
  73. present in the right lister where every item is a button in the
  74. main-window or a selected if you set the "Reduced gadgets".
  75.  
  76. What the buttons do:
  77.  Add:    Add a file to the left lister.
  78.  Delete: Remove a file from the left lister.
  79.  Clear:  Clear all files in the left lister.
  80.  Sort:   Sort all files in the left lister.
  81.  Load:   Load the entire config with files and settings.
  82.  Save:   Save the above..
  83.  Quit:   Quit program and copy back all files from
  84.           Ram:DECH/ if you wish.
  85.  OK:     Exit the file-selector.
  86.  ToRam>: Copy the selected file in the right lister to "Ram:DECH/"
  87.           with all it's corresponding '*local' modules!
  88.  Safety: Safety-copy the selected file from Ram:DECH/ back to
  89.           disk it's original place on disk without changing
  90.           anything in the lister.
  91.  GetRam: Copy back all files copied to Ram:DECH/ to their original
  92.           places on disk and delete the files in Ram:DECH/.
  93.  >Copy>: Copy a filename from the left to the right lister.
  94.  >Refr>: Refresh the selected filename in the right lister
  95.           with the selected filename in the left lister.
  96.  >Del>:  Delete the selected filename from the right lister and
  97.           if the file is in Ram:DECH/ you will be questioned to
  98.           copy back the file from Ram:DECH first.
  99.  
  100.  
  101. The prefs-window (?):
  102. ~~~~~~~~~~~~~~~~~~~~~
  103. Editor:    Your favorite editor with path.
  104.            Has an argument-string at the right.
  105. Viewer:    Your favorite viewer with path.
  106.            Has an argument-string at the right.
  107. Compiler:  The compiler with path.
  108. Output:    An output-file, console or whatever you like.
  109.            You can set up to four %d's that will be the
  110.            coordinates of a console-window.
  111. PubScreen: The name of a pubscreen you want DECH to open on.
  112.  
  113. "Auto-run program after compiling"
  114.   This will let you with a click on just EC both first compile
  115.   and then also run the program.
  116.  
  117. "Popup string-req. before running program"
  118.   This will let you type in som arguments before a program is
  119.   executed
  120.  
  121. "Auto-refresh first file"
  122.   This makes the first file in the "Button"-lister be
  123.   automatically changed to whatever you press or select
  124.   in the left "Source-code"-lister.
  125.  
  126. "Start editor on startup"  with  "Edit: n"
  127.   With this set DECH will start your texteditor with a selected
  128.   file. The file is selected with "Edit:"
  129.  
  130. "Reduce gadgets to EC and RP"
  131.   This will as it say reduce all Cn-/Rn-gadgets in the main-
  132.   window to just EC and RP and the selection is then made in
  133.   the info-window you get when you click the right mouse-button.
  134.  
  135. "Do not warn when closing console"
  136.   This will just skip the requester when you close the console
  137.   and have executed a program in it.
  138.   *** REMEMBER!! This IS dangerous if a program is still
  139.                  outputting text to that console! ***
  140.  
  141. "Don't touch the stdout console"
  142.   This forces DECH to not use the specified "Output:".
  143.  
  144. "Auto-open console on startup"
  145.   Will do exacly what it says.
  146.  
  147. "Use buffered console"  -- Not implemented! --
  148.   This will preserve the 1000 latest characters written when
  149.   you close the console and then when it is reopened it will
  150.   output theese characters so that you can see what you did last.
  151.  
  152. "Priority of executed programs:"
  153.   This is the task-priority of your programs executed.
  154.   It is smart to set this <0 so that if some program would hang
  155.   in a loop, it wouldn't jam the system!
  156.  
  157. "Stacksize of executed programs:"
  158.   The stacksize of the tasks. Must be dividable by 4!
  159.  
  160. |Adjust console-window| lets you with a simple move place your
  161.                         console wherever on the screen you want.
  162.  
  163. |Save| will save the entire config-file to ENVARC:DECH.config.
  164.  
  165. |More| will get you to the string-configuration that earlier
  166.        was found in this same window but have been moved.
  167.  
  168. Usage of the console:  IMPORTENT!  (to prevent crash..)
  169. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  170. When you use the console it is importent that if you have started
  171. a program through 'RP' (or 'Rn') with the console opened and the
  172. program outputs text to the console that you must not close it or
  173. things might go very wrong!!
  174. It is then better to close the console and then start your program,
  175. editor or viewer so that it will get the original 'stdout'-variable
  176. instead, unless you're just debugging a project of yours and don't
  177. want your screen full of consoles everytime you test your program :)
  178.  
  179. You can, in the prefs-window, set "Don't touch the stdout console"
  180. if you start DECH from the CLI/Shell.
  181.  
  182.  
  183. Author:
  184. ~~~~~~~
  185. Daniel Westerberg  alias  Deniil 715! - AmigaE programmer!
  186. e-mail:  deniil@algonet.se
  187.  
  188. Send bug-reports and/or suggestions to me.
  189.  
  190. You can also browse in on OnyxSoft's homepage to se more of
  191. my and Develin's creations!
  192.  
  193. OnyxSoft:  www.alfaskop.net/~onyxsoft/
  194.  
  195.